﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Interface SQLXML</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Interface SQLXML</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>A partir do Microsoft SQL Server JDBC Driver versão 2.0, o JDBC Driver oferece suporte à API do JDBC 4.0, que apresenta a interface java.sql.SQLXML. A interface SQLXML define métodos para interagir com dados XML e manipulá-los. O tipo de dados <b>SQLXML</b> mapeia para o tipo de dados <b>xml</b> do SQL Server.</p>
    <p>A interface SQLXML fornece métodos para acessar o valor de XML valor como um <b>String</b>, um <b>Reader</b> ou <b>Writer</b>, ou como um <b>Stream</b>. O valor XML também pode ser acessado através de um <b>Source</b> ou definido como um <b>Result</b>, que é usado com APIs do Analisador de XML como Modelo de Objeto de Documento (DOM), API Simples para XML (SAX) e API de Fluxo para XML (StAX), assim como transformações XSLT e XPath. </p>
    <p>A tabela a seguir descreve os métodos definidos na interface SQLXML: </p>
    <table width="100%" cellspacing="0" cellpadding="0" border="1" style="background-color: #CCCCCC;"><tr>
          <th colspan="">
            Sintaxe de método
          </th>
          <th colspan="">
            Descrição de método
          </th>
        </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131685" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">void free()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Esse método libera o objeto SQLXML e os recursos que ele contém.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131754" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">InputStream getBinaryStream()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna um fluxo de entrada para ler dados do SQLXML.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131755" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Reader getCharacterStream()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna os dados de <b>XML</b> como um objeto <b>java.io.Reader</b> ou como um fluxo de caracteres.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131756" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">T extends Source T getSource(Class&lt;T&gt; sourceClass)</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna um <b>Source</b> para ler o valor <b>XML</b> especificado por esse objeto <b>SQLXML</b>.</p>
          <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
            O método <b>getSource</b> dá suporte às seguintes origens: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource e java.io.InputStream.<p />
          </div>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131757" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">String getString()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna uma representação de cadeia de caracteres do valor <b>XML</b> designado por este objeto SQLXML.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131758" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">OutputStream setBinaryStream()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Recupera um fluxo que pode ser usado para gravar o valor <b>XML</b> que este objeto SQLXML representa.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131759" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Writer setCharacterStream()</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna um fluxo para ser usado para gravar o valor <b>XML</b> que este objeto SQLXML representa.</p>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131760" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">T extends Result T setResult(Class&lt;T&gt; resultClass)</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Retorna um <b>Result</b> para definir o valor <b>XML</b> especificado por esse objeto <b>SQLXML</b>. </p>
          <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
            O método <b>setResult</b> dá suporte às seguintes origens: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult e java.io.OutputStream.<p />
          </div>
        </td>
      </tr><tr>
        <td colspan="">
          <p>
            <a href="http://go.microsoft.com/fwlink/?LinkId=131762" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">void setString(String value)</linkText></a>
          </p>
        </td>
        <td colspan="">
          <p>Define um valor XML designado por esse objeto SQLXML para a representação <b>String</b> especificada.</p>
        </td>
      </tr></table>
    <p>Os aplicativos podem ler e gravar valores XML para ou de um objeto SQLXML apenas uma vez. </p>
    <p>Quando o método <b>free()</b> é chamado, um objeto SQLXML se torna inválido e não é nem legível nem gravável. Se o aplicativo tentar invocar um método naquele objeto SQLXML diferente do método <b>free()</b>, uma exceção será lançada. </p>
    <p>O objeto SQLXML não fica legível nem gravável quando o aplicativo chama qualquer um dos métodos getter a seguir: <b>getSource</b>, <b>getCharacterStream</b>, <b>getBinaryStream</b> e <b>getString</b>.</p>
    <p>O objeto SQLXML não fica legível nem gravável quando o aplicativo chama qualquer um dos métodos setter a seguir: <b>setResult</b>, <b>setCharacterStream</b>, <b>setBinaryStream</b> e <b>setString</b>.</p>
  </div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="32b7217e-1f0c-473d-9a45-176daa81584e.htm">Dando suporte a dados XML</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>